Related Issue

resolves #882

Documentation

1. TBD
   • routing conventions
   • SSR page props / params
   • API route props / params

Summary of Changes

1. Adds dynamic routing / segment handling for SSR pages and API routes

See the following reference implementations

• https://github.com/thescientist13/greenwood-hackernews
• https://github.com/thescientist13/greenwood-trpc

TODO

1. Add support for dynamic API routing - https://github.com/thescientist13/greenwood-trpc/blob/master/patches/%40greenwood%2Bcli%2B0.33.0-alpha.7.patch
2. Will likely need to adopt a polyfill as URLPattern is only supported in Node >= 23.8.0 (and is experimental)](https://nodejs.org/api/url.html#class-urlpattern) and hosting providers are still not supporting Node 24 yet
3. windows test cases failing
4. Add support in adapter plugins (including graph + url lib backports)
   • Vercel - feat: upgrade Greenwood 0.34.0 w/ dynamic routing example greenwood-demo-adapter-vercel#36
   • Netlify - feat: upgrade Greenwood 0.34.0 w/ dynamic routing example greenwood-demo-adapter-netlify#31
   • AWS (SST) - TODO
   • AWS (Arc) - TODO
5. standardize how the props / params are passed in (consistently) - call it props? params?
   • and should the second param be an object for API routes too?
6. Final refactoring / clean up console logging / comments
7. Final TODOs scan (e.g. passing props to getBody)
8. Update test case per chore(workspace): refactor async test cases #1604

Thoughts / Questions

1. made a Node 24 minimum version tracking issue - update to minimum Node version of >= 24.x #1614
2. Can we now implement a version of getStaticPaths (own issue?)
   • we could then deprecate the source plugin - https://greenwoodjs.dev/docs/reference/plugins-api/#source
3. additional use cases like catch all and optional catch alls (discussion)?
   • https://nextjs.org/docs/pages/building-your-application/routing/dynamic-routes
4. How to handle context for serverless functions? Should maybe track as part of Edge Runtime support for Adapter plugins #1141